Skip to content

[feat] #183 - 전체 최초 다운로드 누적 리포트 추가 - #184

Merged
sangyup12 merged 2 commits into
developfrom
feat/#183
Nov 17, 2026
Merged

sangyup12 merged 2 commits into
developfrom
feat/#183

Conversation

@sangyup12

@sangyup12 sangyup12 commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

🌳 작업한 브랜치

feat/#183 · 기존 자동화 PR #183 후속 변경

✅ 작업한 내용

주간·수동 리포트에 기간별 합계와 함께 전체 최초 다운로드 수와 누적 기준일을 표시합니다. 출시일부터 이어지는 자료에 공백이 있으면 마지막 확인일까지의 누적값과 대기 상태를 표시하며, 누락 날짜를 0으로 추정하지 않습니다.

Apple 보고서의 35일 보존 제한에 대비해 검증된 초기 일별 이력과 이후 정정 자료를 이어 보관합니다. 이력은 AES-256-GCM으로 암호화하고 GitHub Actions Artifact에 90일 보관하며, 업로드 성공 후 동일한 집계 결과를 Discord로 전송합니다. 공개 코드·로그·요약에는 실제 통계나 비밀값을 기록하지 않습니다.

  • ROUTEE_DOWNLOAD_HISTORY_KEY Secret 등록 완료
  • PR 실행은 비밀값 없이 테스트만 수행하며 실제 조회·전송은 develop의 예약·수동 실행에서만 수행
  • 기존 수요일 10:17 KST 일정과 수동 실행 옵션 유지
  • 이력 만료·삭제·장기 미실행에 따른 복구 절차는 README에 설명

❗️PR Point

암호화 이력을 보관한 뒤 전송하며, 이력 공백을 0으로 처리하지 않습니다. 초기 이력은 암호화된 파일만 포함하며 복호화 키는 Repository Secret에 저장합니다.

💬 To Reviewers

Node 테스트 49개 통과, workflow YAML 파싱 및 git diff --check 통과. 실제 초기 CSV의 날짜 범위·명시적 0·합계를 App Store Connect 화면과 대조했고, 암호화 복호화 및 저장된 이력의 리포트 생성도 로컬에서 확인했습니다. 전체 GitHub Actions 수집·보관·전송 흐름은 병합 후 검증이 필요합니다.

Summary by CodeRabbit

  • 새 기능
    • 앱 다운로드 보고서에 출시 이후 누적 다운로드 합계와 집계 기간이 표시됩니다. 아직 확인되지 않은 날짜가 있으면 마지막 확인 날짜와 집계 대기 상태를 안내합니다.
    • 저장된 집계 이력을 복원해 보고서를 생성하고, 전체 이력을 암호화해 보관할 수 있습니다. 예약 실행 또는 설정에 따라 저장된 보고서를 Discord로 전송합니다.
  • 개선 사항
    • 과거 날짜의 집계값 변경도 이력에 반영되며, 누락된 날짜가 있는 보고서는 부분 집계로 표시됩니다.

@coderabbitai

coderabbitai Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Explain Change →

Caution

Review failed

The pull request is closed.

Walkthrough

워크플로가 암호화된 App Store 다운로드 이력을 복원하고 갱신합니다. 보고서는 연속해서 확인된 일별 데이터의 누적 합계를 표시합니다. Discord 전송은 수집·저장 단계와 분리되어 조건에 따라 실행됩니다.

Changes

App Store 다운로드 이력

Layer / File(s) Summary
이력 검증 및 암호화
automation/app-store-discord/src/history.mjs, automation/app-store-discord/test/history.test.mjs, automation/app-store-discord/.env.example, automation/app-store-discord/.gitignore, automation/app-store-discord/history-seed.enc.json
이력의 앱 ID, 날짜, 일별 집계값과 크기를 검증합니다. AES-256-GCM 암호화·복호화와 암호화된 시드 이력을 추가합니다.
이력 아티팩트 복원
.github/workflows/app-store-downloads.yml, automation/app-store-discord/scripts/restore-history.mjs, automation/app-store-discord/test/history.test.mjs
복원 스크립트가 신뢰 조건에 맞는 최신 아티팩트를 찾고 실행·아티팩트 ID를 기록합니다. 워크플로는 복원할 이력이 없으면 시드 이력을 입력으로 사용합니다.
이력 갱신 및 Discord 전송
.github/workflows/app-store-downloads.yml, automation/app-store-discord/scripts/run-report.mjs, automation/app-store-discord/src/apple.mjs, automation/app-store-discord/src/run-report.mjs, automation/app-store-discord/test/apple.test.mjs, automation/app-store-discord/test/run-report.test.mjs
보고서 실행이 복원한 이력을 바탕으로 수집을 이어가고, 전송 전에 이력을 저장합니다. 워크플로는 이력을 아티팩트로 보관하고, 예약 실행 또는 입력 조건에 따라 저장된 보고서를 별도로 전송합니다.
누적 집계 및 리포트 표시
automation/app-store-discord/src/reports.mjs, automation/app-store-discord/test/reports.test.mjs, automation/app-store-discord/scripts/preview.mjs
출시일부터 연속해서 확정된 일별 기록을 합산하고 보고서에 누적 기간과 합계를 표시합니다. 누락되거나 미확정된 날짜 이후의 집계는 대기 상태로 표시합니다.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Feature

Sequence Diagram(s)

sequenceDiagram
  participant Actions as GitHub Actions
  participant Restore as restore-history.mjs
  participant API as GitHub API
  participant Report as run-report.mjs
  participant Apple as Apple API
  participant Discord
  Actions->>Restore: 이력 아티팩트 검색 시작
  Restore->>API: 아티팩트 및 실행 정보 조회
  API-->>Restore: 후보 아티팩트 정보 반환
  Restore-->>Actions: 선택한 실행 및 아티팩트 ID 기록
  Actions->>Report: 복원된 이력으로 보고서 실행
  Report->>Apple: 다운로드 데이터 수집
  Apple-->>Report: 날짜별 다운로드 데이터 반환
  Report-->>Actions: 암호화된 이력 저장 및 보고서 생성
  Actions->>Discord: 조건에 따라 저장된 보고서 전송
Loading

Possibly related PRs

  • Team-Routee/Routee-iOS#183: App Store 주간 리포트의 기존 워크플로와 스크립트를 바탕으로 이력 보관·복원 및 누적 집계를 추가합니다.
Merge Risk: Low · up to e5f46

The encrypted history, restore and cumulative-report flow looks sound. One narrow gap remains: running the CLI with an output history file but no input history file fetches all reports and then fails to save. The scheduled workflow does not hit this. Reject that argument combination up front before merging.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@sangyup12 sangyup12 self-assigned this Nov 17, 2026
@sangyup12 sangyup12 added ⚙️ Setting 프로젝트 관련 설정 및 변경 ⚔️ sangyup 리드 이상엽이오 labels Nov 17, 2026
@sangyup12
sangyup12 merged commit 4a6415f into develop Nov 17, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⚔️ sangyup 리드 이상엽이오 ⚙️ Setting 프로젝트 관련 설정 및 변경

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant